home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Configuration / Dockernaut 1.4.2 / Dockernaut Docs < prev    next >
Text File  |  1994-03-21  |  15KB  |  264 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9. Dockernaut Docs
  10.  
  11. Version 1.4.2
  12.  
  13. Dockernaut is shareware.  It is not to be sold or distributed for profit (above any standard on-line service costs) without my expressed written permission. I.e.: Compuserve, AOL, etc., are OK.  Educorp is not!  Dockernaut may only be distributed with the accompanying documentation intact.
  14.  
  15. Try it out for a few weeks, if you like it and continue to use it, please register by sending $15 US to:
  16.  
  17. Steve Martin
  18. 6632 Warm Breeze Lane
  19. Dallas, TX  75248-5021
  20.  
  21. Thank you.
  22.  
  23. Dockernaut has extensive balloon help.  Please use to learn about its features.
  24.  
  25. DESCRIPTION
  26.  
  27. Dockernaut allows you to have different sets of application preferences for each dock that you use with your Duo.  Other PowerBook users can have different sets when they use a different sized main monitor.
  28.  
  29. As a simple example, let's look at the location of the Trash icon in the Finder.  Some people like to move the Trash icon to the very bottom right corner of the screen (or some other non-standard location).  If you do this on a 640x400 display and then later use a 640x480 monitor, the Trash icon will no longer be in the bottom right corner, it will be an inch or two up from the bottom, since the Finder remembers where you put it.  The Finder like many applications and extensions has a preference file where it stores options set by the user.  The location of the Trash icon is one of the options stored in that file.  Preference files are usually stored in a folder called "Preferences" inside the System Folder.  If you look there, sure enough, you will find a file called "Finder Preferences".
  30.  
  31. This is where the magic of Dockernaut comes in.  If you configure Dockernaut to manage the "Finder Preferences" file, it will keep two copies of that file, one for your 640x480 monitor and one for the 640x400 display.  At startup, Dockernaut will look at the size of the screen and determine which "Finder Preferences" file to use.  Once you place the Trash icon while using each sized monitor, the icon will stay where you wanted it when you switch back and forth.
  32.  
  33. Look in the Sample Dockernaut Uses section for a list of other preference files  that people have used Dockernaut with to get some ideas.
  34.  
  35. Dockernaut has a number of secondary features that you can configure from within the control panel which will now be explained.
  36.  
  37. "Switch Colors in Dock"
  38.  
  39. When I first got my Duo 230, I also got a Duo Dock and added an E-Machines Futura MX card to drive a 16 inch monitor.  I soon noticed that when I used my Duo away from the dock, the graphics card would forget the number of colors that I had configured it to display.  Every time I came back, it would boot in black and white!  Now of course I could fix it by opening the Monitors control panel but who wants to watch all of their extension icons load in black and white and then have to change the monitors control panel after startup.  Not me!
  40.  
  41. If you check this box, Dockernaut will attempt to switch the main monitor to the specified number of colors when it loads at startup time.  I say attempt because if you have it set to "Millions" of colors and the main monitor only supports 256 colors, it will switch to 256 colors.
  42.  
  43. "Type Set Key"
  44.  
  45. This is a very powerful feature that lets Dockernaut control popular extension managers like Conflict Catcher II and Now Startup Manager (part of Now Utilities).  These extension managers allow you to create different sets of extensions and control which set gets loaded at startup time by holding down a key.
  46.  
  47. If you check this box, Dockernaut will hold down a key for you when you switch docks.  You can therefore create a set of extensions to load for each dock and have Dockernaut automatically select the right one at startup time.
  48.  
  49. In order for this feature to work, you must have the Dockernaut Extension load before the extension manager.  For this reason, Dockernaut Extension has two spaces before its name.  You may have to edit its name or the name of your extension manger to make sure that Dockernaut Extension loads first.
  50.  
  51. "Every Startup"
  52.  
  53. This is a sub-function of Type Set Key that works around a quirk in Now Startup Manager 4.0.2.  In the past (and still, with Conflict Catcher II) if you changed extension sets by holding down a key at startup, that set would remain in effect until you changed sets again.  With Now Startup Manager 4.0.2, however, the set is only in effect for that one startup.  The previous default set will load when you Restart.
  54.  
  55. If you check the "Every Startup" box, Dockernaut will type the set key at every startup instead of just when you switch docks.
  56.  
  57. The File List
  58.  
  59. Dockernaut displays a list of the files that you have chosen for it to manage.  You can add to this list with the "Add..." button.  This will present you with a standard file dialog so that you can select a preference file for Dockernaut to manage.  By default, the Preferences folder will be visible since it makes most sense to add preference files to the list.  You can remove files from the list by selecting them and clicking on the "Remove" button.
  60.  
  61. Current Dock Information
  62.  
  63. The upper right quadrant of the Dockernaut control panel displays information about the currently attached dock (if there is one).  This information is displayed as defined in Apple's documentation but does not seem to be correct for some docks.  Do not be concerned.  This display is just for informational purposes.  Use balloon help to get descriptions of the individual elements.
  64.  
  65. Sets
  66.  
  67. The lower right quadrant displays information about each set that Dockernaut has created and allows you to configure Dockernaut by telling it what information to use to create different sets.  Again, use balloon help to get information about the individual dock attributes.
  68.  
  69. When you open the Dockernaut control panel, it will display the set that was made active at startup.  The size of the main monitor is displayed, along with various dock attributes and what kind of power (battery or A/C) your Macintosh was running on.
  70.  
  71. You may look through the other sets that were created and delete those for docks or monitors that you no longer use.   Deleting a set also deletes all the extra copies of the preference files that Dockernaut has created.
  72.  
  73. You can also change the set key (see "Type Set Key" above) for each set.  Click the "Change Key..." button and when presented with the dialog, type the key that you want Dockernaut to type when it switches to that set.
  74.  
  75. Depending on how you use your Macintosh, you can control how Dockernaut determines it should create a new set.  If you are only customizing preferences for things like the Trash icon placement or desktop background pictures (using Fun Pictures, for example), you may only want sets for different sized monitors.  There would be no reason to have a set for a Floppy Adapter, a set for a SCSI MicroDock, and a set for no dock.  You would only want different sets for 1024x768, 640x480, and 640x400 monitors.
  76.  
  77. "Use Screen Size" (checked by default)
  78.  
  79. If checked, Dockernaut will create a set for every monitor size that you use.
  80.  
  81. "Use Dock Attributes" (checked by default)
  82.  
  83. If checked, Dockernaut will create a set for every dock that you use.
  84.  
  85. "Use Power" (not checked by default).
  86.  
  87. If checked, Dockernaut will create a sets for battery and A/C power.
  88.  
  89. Lets walk through an example or two to see how this works.  We will use a Duo 270c which can have two screen sizes (640x480 and 640x400) and a SCSI MicroDock.  Here are examples of the sets that would be created depending on the settings of the various "Use" checkboxes.
  90.  
  91. All three checked
  92.  
  93. 8 sets
  94. 640x480 undocked battery,  640x480 undocked A/C
  95. 640x480 docked battery, 640x480 docked A/C
  96. 640x400 undocked battery, 640x400 undocked A/C
  97. 640x400 docked battery, 640x400 docked A/C
  98.  
  99. Use Screen Size and Use Dock Attributes checked
  100.  
  101. 4 sets
  102. 640x480 docked, 640x480 undocked
  103. 640x400 docked, 640x400 docked
  104.  
  105. Use Screen Size and Use Power checked
  106.  
  107. 4 sets
  108. 640x480 battery, 640x480 A/C
  109. 640x400 battery, 640x400 A/C
  110.  
  111. Use Screen Size checked
  112.  
  113. 2 sets
  114. 640x480, 640x400 
  115.  
  116. When a set is created, all the information (Screen Size, Dock Attributes, and Power) are collected and displayed.  If you change the settings of the "Use" checkboxes after sets have been created, you will still see all the information for the sets, but only the criteria you selected will be used to choose the set.
  117.  
  118. In the preceding example if you had originally checked all three and had 8 sets get created, but then later checked only the use screen size checkbox you would still have 8 sets, but only the first 640x480 and the first 640x400 sets would get used.
  119.  
  120. SAMPLE DOCKERNAUT USES
  121.  
  122. Finder Prefs
  123. You can have different Trash can locations.  This is useful if you like to have it in the extreme bottom right corner and use monitors of different sizes.
  124.  
  125.  
  126. FunPictures Prefs (FunPictures™)
  127. When docked and using a 1024x768 color monitor you can have FunPictures choose form a collection of high resolution color pictures.
  128. When not docked you can have it choose from a collection of smaller greyscale pictures.
  129.  
  130. MacTCP Prep
  131. When docked use one ip address for ethernet.  When not docked use another address for PPP.
  132.  
  133. Now Menus Prefs
  134. Use Chicago  12 font for large monitors.
  135. Use Geneva 9 font for small monitors.
  136.  
  137. Now Toolbox Prefs
  138. Keep different sets of recently used Applications for different environments.
  139.  
  140. PBTools™
  141. Set it to always load Appletalk then...
  142. When docked have Appletalk turned on
  143. When not docked have Appletalk turned off
  144.  
  145. Randomizer (After Dark™ module)
  146. Use all those colorful screen savers that only run with 256 colors when you are docked.
  147. Automatically use a different set with those that look good in 16 grays when you are not.
  148.  
  149. SoftPC Prefs (SoftPC™)
  150. When using a large monitor have the SoftPC™'s window open up in its larger size.
  151. When using a PowerBook screen have it open in the smaller size (so it fits!).
  152.  
  153. Word Settings(5) (Microsoft Word™)
  154. When docked you have plenty of screen real estate so you have the Toolbar enabled.
  155. When not docked you can have the Toolbar disabled.
  156.  
  157.  
  158. STARTUP ICONS
  159.  
  160. There are 5 startup icons.
  161.  
  162. 1 - Shows the transition from a docked to undocked state.
  163. 2 - Shows the transition from an undocked to a docked state.
  164. 3 - Shows the transition from one dock to another.
  165. 4 - Shows docked status.
  166. 5 - Shows undocked status.
  167.  
  168. TECHNICAL NOTES (How it works)
  169.  
  170. For each file in Dockernaut's list, multiple copies will be made.  They will have ".1", ".2", .etc.. as many sets as get created (based on how many docks or different sized Monitors you use).  If you remove a file from Dockernaut's list you may want to delete these extra preference files.  If you don't, they will not cause any problems, they will just take up disk space.  And they will be there if you decide to add that pref file back again later.
  171.  
  172. When Dockernaut loads at startup time, it checks to see if your configuration has changed since the last time you started up.  If it has it moves the current preference files, renaming them with the postfix corresponding to the previous configuration.  It then copies the preference files with the postfix corresponding to the current configuration into their normal file names.  If the current configuration had not been seen by Dockernaut before, a new "set" is created and new copies of the preferences files are created for it.
  173.  
  174. KNOWN LIMITATIONS
  175.  
  176. Switching Ethertalk vs. Appletalk.  Apparently some people have gotten this to work but only by using the Network control panel version 2.3.3 which ships with System 7.1 installer disks.
  177.  
  178. Dockernaut cannot control the placement of other Finder icons, only the Trash icon.
  179.  
  180. Dockernaut cannot control the default printer selection.
  181.  
  182. Dockernaut cannot control the desktop pattern (except by using Dockernaut with Fun Pictures or Wallpaper, or possibly other desktop utilities).
  183.  
  184. Dockernaut cannot tell the difference between two docks of the same model.  I've heard rumors that DuoDocks may have unique identifying numbers.  If someone tells me how to read them, I'll add the feature!
  185.  
  186.  
  187. DISCLAIMER
  188. I make no warrantee as to the functionality or usefulness of this program.  It has been beta tested by several Duo users but may still contain bugs.  Please report bugs and suggestions to any of the addresses at the end of this document.
  189.  
  190. VERSION HISTORY
  191.  
  192. 1.4.2
  193.  
  194. Minor fixes: Workaround for DuoDock vs. VM bug.  Fixed version resource of extension.
  195.  
  196. 1.4
  197. Changed preference file format (sorry!)  You will have to add the files again and let the sets get redefined.
  198. Added balloon help.
  199. Separated control panel and extension so the System puts them in the right place by default.
  200. Allow the user to use any key as a set key.
  201. ".1", ".2", etc. files no longer show up in the "Add..." dialog.
  202. The limit of 10 sets has been removed.
  203. Dockernaut now works correctly with virtual memory (and RAM Doubler)
  204. The SCSI and serial port attributes were switched.  This has been fixed.
  205. A delete set button has been added.
  206. You can now define the key that gets typed by the "Type Set Key" feature to any key you want.
  207.  
  208. 1.3
  209.  
  210. Put all information in one display.
  211. Add extension manager startup key option.
  212. Display proper startup icon on 640x480 Duo 270c (and 180c I imagine.)
  213.  
  214.  
  215. 1.2.2
  216.  
  217. Fixed a bug where the file list would become corrupted if you switched to the sets screen after adding or deleting a file from the list.
  218. Fixed a typo that caused 1.2 to crash on machines without the DockingDispatch trap.
  219.  
  220. 1.2
  221. Added descriptions of the set information fields and startup icons to the documentation.
  222. Get dock name from dock ROM.
  223. Added color depth choice popup menu.
  224. Worked around an apparent bug in DockingDispatch when in a DuoDock that crashes when Virtual Memory is on.  The "Use Dock Attributes" feature is effectively disabled when VM is on.
  225.  
  226. 1.1
  227. Changed to support more than 2 sets and make the set choosing criteria more straightforward.
  228. Made the color switching better, the video card PRAM and scrn resource are now also updated so that the setting is permanent (as if you changed it with the Monitors cdev).
  229. Added information screen and ability to change dock differentiating criteria.
  230. Fixed a bug that could cause Super Boomerang to hang at startup.
  231.  
  232. 1.0
  233. First release
  234.  
  235. CREDIT where it is due:
  236.  
  237. ShowIcon7 was used to draw the Startup icons.  The following was in the header for its source code:
  238.  
  239. This code is based on Patrick C. Beard's ShowIconFamily
  240. by Patrick C. Beard, which in turn was derived from the
  241. original ShowInit by Paul Mercer, Darin Adler,
  242. Paul Snively, and Steve Capps.
  243.  
  244. Modified by James W. Walker for compatibility with IconWrap 1.2,
  245. for use as a separate code resource, and to use the new System 7
  246. icon-dawing routines.  This code is in the public domain.
  247.  
  248. Addresses for James W. Walker: 76367,2271@compuserve.com or
  249. walkerj@math.scarolina.edu
  250.  
  251. Dockernaut CREDITS
  252. Written by Steve Martin
  253. A happy Duo 230 and Duo Dock owner.
  254. 6632 Warm Breeze Lane
  255. Dallas, TX 75248
  256.  
  257. Please report any bugs to Steve Martin
  258. Compuserve: 72727,1471
  259. America Online: Steve Mart
  260. Applelink: SteveMartin
  261. internet: martin@metronet.com
  262.  
  263.  
  264.